home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 001 / protime.arc / PROTIME.DOC < prev   
Text File  |  1985-06-14  |  5KB  |  128 lines
  1. Instructions (revision 2) for:
  2.   "ProTime for MS-DOS, version 2.2, 13-June-1985"
  3.   Copyright (C) 1985 by Wayne Conrad, All Rights Reserved
  4.  
  5.  
  6. NOTICE: Permission is granted to use and distribute this program free of
  7. charge, provided that that no fee of any kind is charged for such use or
  8. distribution.
  9.  
  10.  
  11. PURPOSE
  12.  
  13. Protime is designed for use with the Prometheus Promodem 1200.  The Promodem
  14. has a built in real-time clock.  ProTime reads the time string from the
  15. Promodem and sets the DOS time accordingly.  So, if you have a Promodem,
  16. then the ProTime program could be an acceptable substitute for a hardware
  17. clock board.
  18.  
  19.  
  20. SETTING THE PROMODEM'S TIME
  21.  
  22. Before you can use ProTime, you need to make sure your Promodem's time
  23. and date is set correctly.  Fire up your favorite communications program,
  24. and type
  25.  
  26.   AT@T<return>
  27.  
  28. The Promodem will respond with a the current date and time.  If it is not
  29. correct, then set it with this command:
  30.  
  31.   AT@T=mm/dd/hh/mmPP<return>
  32.  
  33.   where:  mm is the current month, from 1 to 12
  34.           dd is the current day, from 1 to 31
  35.           hh is the hours, from 1 to 12 (civilian time)
  36.           mm is the minutes
  37.           PP is either "AM" or "PM"
  38.  
  39. You can then enter the "AT@T" command to see if you set it properly.
  40.  
  41. You should leave your promodem on continuously unless you have the optional
  42. command processor with battery-backup.  If you do not have the battery-
  43. backup and you turn the modem off, it will forget the time and date.
  44.  
  45.  
  46. INSTALLING PROTIME
  47.  
  48. To cause ProTime to automatically set the date and time upon boot-up, put
  49. the program on your boot disk and add the following line to your
  50. AUTOEXEC.BAT file:
  51.  
  52.   PROTIME/<computer-type>
  53.  
  54.   where <computer-type> is one of the following:
  55.  
  56.     I if you have an IBM-PC or close compatible
  57.     S if you have a Sanyo 555
  58.  
  59. For example, here is how to create an AUTOEXEC.BAT file which will run
  60. Protime upon boot-up on an IBM-PC:
  61.  
  62.   A>COPY CON: AUTOEXEC.BAT
  63.   PROTIME/I                             <--Or /S for the Sanyo 555
  64.   ^Z                                    <--Enter a control-z
  65.        1 file(s) copied
  66.  
  67.   A>
  68.  
  69.  
  70. SETTING THE YEAR
  71.  
  72. The Promodem does not keep track of the year.  Therefore, there are three
  73. different ways that the ProTime program uses to determine what year it is:
  74.  
  75.   (1) If the DOS year is already set to 1985 or greater, then it is assumed
  76.       to be valid and is used as the current year
  77.   (2) If the DOS year is invalid, then the program attempts to read the
  78.       current year from the disk file 'PROTIME.DTA'.  If it finds this
  79.       file, and if it is able to read it successfully, then it uses it
  80.       for the current year
  81.   (3) If both (1) and (2) are unsuccessful, then the year is assumed to
  82.       be 1985.
  83.  
  84. Throughout 1985, the program should have no problem determining the correct
  85. year.  After 1985, you will need to create a disk file PROTIME.DTA which
  86. contains the current year.  Here is how to do that:
  87.  
  88.   A>COPY CON: PROTIME.DAT
  89.   1986                                   <--Enter the current year
  90.   ^Z                                     <--Enter a control-Z
  91.        1 file(s) copied
  92.  
  93.   A>
  94.  
  95.  
  96. END-OF-MONTH and END-OF-YEAR rollover
  97.  
  98. The Promodem thinks that there are 31 days in each month.  If the Protime
  99. program finds a date like 9/31, it will assume that the month has changed,
  100. and correct it to 10/1.  However, as soon as the REAL DATE changes to
  101. 10/2, the promodem will roll over the 10/1, and Protime will be unable to
  102. tell that this is in fact the incorrect date.  So, at the beginning of
  103. each month, you need to use your communication program to tell the
  104. Promodem what the date REALLY is.
  105.  
  106. Also, when the year changes, you will need to enter the new year in the
  107. PROTIME.DAT.
  108.  
  109.  
  110. SUPPORT FOR OTHER COMPUTERS
  111.  
  112. I would like to make ProTime work with as many computers as possible.  The
  113. source code is written in Turbo Pascal, version 2.00B for PC-DOS.  All it
  114. takes to get this program to run on other MS-DOS computers is to change the
  115. serial-communications routines, which are strategically separated from the
  116. rest of the program.  If your computer will not run ProTime, and you have
  117. the ability to program the serial port of your computer, please let me know
  118. and I'll see that you get a copy of the source code.
  119.  
  120. My mailing address is:
  121.   Wayne Conrad
  122.   5656 North 17th Avenue, apt E42
  123.   Phoenix, AZ  85015
  124.  
  125. My bulletin-board is:
  126.   Fido 5 in Net 114, "Pascalaholics Anonymous"
  127.   (602) 246-1786, 24 hours/day, 300/1200 bps
  128.